package java.lang;

/**
 * 类层级的根类
 * 每个类都有父类
 * 数组的父类也是 Object, 数组有各种 Object 的方法
 */
public class Object {

    private static native void registerNatives();
    static {
        registerNatives();
    }

    /**
     * 获取当前对象的类对象
     */
    public final native Class<?> getClass();


    /**
     * hashCode() 方法
     * 只要对象不修改, hashCode() 总是返回相同的整数值
     */
    public native int hashCode();

    /**
     * equals() 方法的默认实现就是 直接 == 即比较内存地址
     * 重写 equals() 务必也重写 hashCode() 因为 HashMap 会用到 hashCode() 获取 hash 值
     */
    public boolean equals(Object obj) {
        return (this == obj);
    }

    /**
     * 实现 Cloneable 接口的类才允许调用 clone() 方法
     * clone() 默认是浅拷贝, 即引用类型字段是内存地址值的拷贝, 堆中对象都是同一份, 没有复制

     */
    protected native Object clone() throws CloneNotSupportedException;

    /**
     * 建议所有子类都重写该方法
     * 返回人类易读的文本
     * 默认返回 getClass().getName() + '@' + Integer.toHexString(hashCode())
     * 即类全限定名@hashCode()的 16 进制
     */
    public String toString() {
        return getClass().getName() + "@" + Integer.toHexString(hashCode());
    }

    /**
     * 唤醒正在等待中的单个线程 (即唤醒某个 wait() 的线程)
     * 调用本方法必须获取到监视器锁, 否则异常 IllegalMonitorStateException
     */
    public final native void notify();

    /**
     * 与 notify() 类似, 不过唤醒的是所有等待该监视器锁的线程
     */
    public final native void notifyAll();

    /**
     * 线程进入等待状态, 放弃 cpu 使用权, 直到被 notify() / notifyAll() 唤醒
     * 超过指定时间会停止等待
     */
    public final native void wait(long timeout) throws InterruptedException;


    public final void wait(long timeout, int nanos) throws InterruptedException {
        if (timeout < 0) {
            throw new IllegalArgumentException("timeout value is negative");
        }

        if (nanos < 0 || nanos > 999999) {
            throw new IllegalArgumentException(
                                "nanosecond timeout value out of range");
        }

        if (nanos > 0) {
            timeout++;
        }

        wait(timeout);
    }

    public final void wait() throws InterruptedException {
        wait(0);
    }

    /**
     * 通知 gc 本对象可以被回收
     */
    protected void finalize() throws Throwable { }
}
